fix: add skills/ directory for Claude Code skill discovery#2
Merged
Conversation
Claude Code discovers skills by scanning skills/<name>/SKILL.md inside plugin directories. Move SKILL.md and reference docs into the canonical skills/skill-issue/ path so the skill is automatically discovered.
The canonical location is now skills/skill-issue/SKILL.md. The Python wheel no longer bundles SKILL.md as package data.
plugin.json: 1.0.0 → 1.1.0 (new skills/ layout) pyproject.toml: 1.2.0 → 1.3.0 (SKILL.md removed from wheel)
The CLI's init --claude and init --print commands need to read SKILL.md. Add a symlink at skill_issue/SKILL.md → ../skills/skill-issue/SKILL.md so the package-relative path works for both pip installs (setuptools follows symlinks when building wheels) and dev mode. Also update _get_skill_md_path() to check skills/skill-issue/SKILL.md as a fallback for dev checkouts where the symlink might not resolve.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
skills/<name>/SKILL.mdinside plugin directories. The SKILL.md was at the repo root and insideskill_issue/(Python package), neither of which Claude Code scans.skills/skill-issue/SKILL.mdwith co-located reference docs, removed stale copies, bumped versions.Root Cause
Claude Code's skill discovery pipeline scans
<plugin-root>/skills/<name>/SKILL.md. The skill-issue package placed SKILL.md at the repo root (not scanned) and inside the Python packageskill_issue/SKILL.md(also not scanned). Adding the standardskills/skill-issue/SKILL.mdpath makes it discoverable.Changes
skills/skill-issue/SKILL.mdskills/skill-issue/references/*.mdreferences/)SKILL.md(root)skill_issue/SKILL.mdpyproject.toml.claude-plugin/plugin.jsonTest plan
skill-issueappears in the available skills system reminderskill-issueCLI still works (skill-issue --help)🤖 Generated with Claude Code